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Summary of CDOS System Calls 


The following is a summary, listing all of the system calls implemented in 
Series 2 CDOS together with their entry and return parameters. The system 
calls are listed in order of the number which is loaded into the C 


register to specify the desired call. 


Number Function Entry Parameters Return Parameters 
0. PROGRAM ABORT none none 
1 READ CONSOLE none A = character 

(with echo) (parity bit reset) 
2 WRITE CONSOLE E = character none 
3 READ READER. none A = character 
4 WRITE PUNCH E = character none 
5 WRITE LIST E = character none 
6 not in use 
7 GET I/O BYTE none A = I/O byte 
8 SET I/O BYTE E = I/O byte none 
9 PRINT BUFFERED DE = buffer address none 

LINE 
10 (OAH) INPUT BUFFERED DE = buffer address none 

LINE 
11 (O0BH) TEST CONSOLE none A = -1 (FFH) if ready 

READY A = 0 if not ready 

12 (OCH) DESELECT none none 

CURRENT DISK 
13 (0DH) RESET CDOS AND none none 

SELECT DRIVE A 
14 (OEH) SELECT CURRENT E = disk drive no. none 

DISK 
15 (OFH) OPEN DISK FILE DE = FCB address A = directory block 

A = -1 (FFH) if not found 
16 (10H) CLOSE DISK FILE DE = FCB address A = directory block 
A = -1 (FFH) if not found 


17 


18 


19 


20 


21 


22 


25 


128 (80H) 


129 (81H) 


-130 (828) 


(11H) 


(12H) 


(13H) 


(14H) 


(15H) 


(16H) 


(17H) 


(18H) 


(19H) 
( 1AH) 


(1BH) 


Function 


SEARCH DIRECTORY 
FOR FILENAME 


FIND NEXT ENTRY 
IN DIRECTORY 


DELETE FILE 


READ NEXT 
RECORD 


WRITE NEXT 
RECORD 


CREATE FILE 


RENAME FILE 

GET DISK LOG-IN 
VECTOR 

CURRENT DISK 
SET DISK BUFFER 
DISK CLUSTER 
ALLOCATION MAP 
READ CONSOLE 
(with no echo) 


GET USER REGI- 
STER POINTER 


SET USER 
CNTRL-C ABORT 


Entry Parameters 


DE = 


DE = 


DE = 


none 


none 


none 


FCB address 


FCB address 


FCB address 


FCB address 


FCB address 


FCB address 


FCB address 


buffer address 


address of “C 
handler (0 to 
reset; 

-l to disable) 


Return Parameters ¢ 


directory block 
-l (FFH) if not found 


directory block 
~1 (FFH) if not found 


= number of entries 


ow 


deleted 


0 if OK 

1 if end of file 

2 if tried to read 
unwritten records 


0 if OK 

1 if entry error 

2 if out of disk space 
-1 (FFH) if out of 
directory space 


directory block 

-l1 (FFH) if out of 
directory space or 
file already exists. 


number of entries 
renamed 


those disks currently 
logged-in 


disk drive number 


address of bitmap 
number of clusters 
sectors/cluster 


character 


BC = pointer to user 


none 


register pointers 


YON 


131 


132 


133 
134 


135 


136 


137 


138 


139 
140 
141 


142 


143 


144 


(83H) 


(84H) 


(85H) 


(86H) 


(87H) 


(88H) 


(89H) 


(8AH) 


(8BH) 
(8CH) 
(8DH) 


(8EH) 


(8FH) 


(90H) 


Function 


READ LOGICAL 
BLOCK 


WRITE LOGICAL 
BLOCK 


not in use 
FORMAT NAME 
TO FILE 
CONTROL BLOCK 


UPDATE 
DIRECTORY ENTRY 


LINK TO PROGRAM 


MULTIPLY 
INTEGERS 


DIVIDE 
INTEGERS 


HOME DRIVE 
EJECT DISKETTE 


GET VERSION OF 
OPERATING SYSTEM 


SET SPECIAL 
CRT FUNCTION 


SET DATE 


READ DATE 


Entry Parameters 


DE 


= block number 


B = drive number 
B bit 7 set if 


interleaved 


B bit 6 set 


DE = block number 

B = drive number 

B top bit = 1 if 

interleaved 

HL = address of 
string 

DE = FCB address 

DE = FCB address 

DE = FCB address 

DE = factor 1 

HL = factor 2 

HL = dividend 

DE = divisor 

B = drive number 

E = drive number 

none 

D = column address/ 
special function 

E = row address/0 

B = day 

D = month 

E = year-1900 

none 


indicates block 
number is in 
HLDE reg pairs 


Return Parameters 


A = 0 if OK 

A= 1 if I/O error 

A= 2 if illegal request 

A = 3 if illegal block 

A= 0 if OK 

A= 1 if I/O error 

A = 2 if illegal request 

A = 3 if illegal block 

HL = address of 
terminator 

DE = FCB address 

none 

A = -1 (FFE) if error; 
else execute at 100H 

DE = product 

HL = quotient 

DE = remainder 

none 

none 

B = version-~number 

C = release~-number 

none 


none 

A = day 

B = month 

C = year-1900 


145 


146 


147 


148 


149 
150 
151 


L52 


153 


154 


155 
156 
157 


Function Entry Parameters Return Parameters ( 
(91H) SET TIME OF DAY B = seconds none 
D = minutes 
E = hours (24 hr. time) 
(92H) READ TIME OF DAY none A = seconds 
B = minutes 
C = hours (24 hr. time) 
(93H) SET PROGRAM E = return code A = previously set return 
RETURN CODE for next program code 
(94H) SET FILE DE = FCB address none 
ATTRIBUTES B = new attributes 
(95H) READ DISK LABEL DE = FCB address none 
(96H) TURN MOTORS OFF none none 
(97H) SET BOTTOM OF E = high byte of none 
CDOS IN RAM address of bottom 
of CDOS 
(98H) READ CURRENT DE = FCB address A = 0 if OK 
RECORD A= 1 if end of file 
A = 2 if tried to read 
unwritten records 
(99H) WRITE CURRENT DE = FCB address A = 0 if OK 
RECORD A = 1 if entry error 
A = 2 if out of disk space 
A = -l (FFH) if out of 
directory space 
(9AH) CHECK IF DE = FCB address A = 0 if allocated 
ALLOCATED A = -1 if not allocated 
(9BH) not in use 
(9CH) LIST DIRECTORY DE = FCB address none 
(9DH) SET OPTIONS D = desired option A = old options 
E = mask 
bit 0 = CNTRL-P flag 
bit 1 = read after write 
Options bit 2 = ESCape key use as carriage return 
bit 3 = do not echo carriage return 
bit 6 = do not echo 


~ Number Function Entry Parameters Return Parameters 


0 oe oe oe oe ae en teats eae ees ee ee ce ae ee ee ee ae Oe oe ee ee ee ee ee ee cee ee oe ee Oe Oe ee ee ee oe ee oe 


158 (9EH) DELETE EXTENTS DE = FCB address A = 0 if not found 
A = 1 if found and erased 
159 (S9FH) GET MASTER none A = master drive 
DRIVE B = last drive used in 
batch (@) 


SUMMARY OF CDOS HARD DISK ERROR MESSAGES 


If CDOS encounters an error when accessing a hard 
disk drive a message will be displayed in the 
following format: 


READ-ERROR 
WRITE~-ERROR 
HOME-ERROR 


SEEK-ERROR 


DRIVE AA CYLINDER BB HEAD CC SECTOR DD STATUS EE FF 


Note that all numbers are displayed in hexadecimal 
notation. 


AA represents a drive designation which may range 
from A through H. 


BB represents the cylinder number which may range 
from 0 through 161h. 


cc represents the head number which may range 
from 0 through 2. 


DD represents the sector number which may range 
from 0 through 13h. 


There are two types of errors: fatal and system. 
Fatal errors are errors that remain after an I/O 
operation has been retried a fixed number of times. 
System errors are errors that occur when an I/0 
operation initially fails, then succeeds before the 
fixed number of retries is exceeded. 


EE represents a fatal error which may range from 
00 through ODh. Refer to the following pages. 


FF represents a system error which may range from 
00 through 06h. Refer to the following pages. 


More 


information concerning errors and fault 


conditions can be found in the Cromemco Hard Disk 
Specification manual, part number 023-6002. 


FATAL ERRORS 


The following error codes are displayed when a 
fatal disk error occurs. 


00 Failed to Seek & Read Header during R/W 


An error occurred during an 
attempt to seek & read header 
preceding a read/write 
operation. 


Ol Failed to Seek - Timeout 


The seek did not complete 
within a specified time. Check 
the drive electronics. 


02 Fault Occurred during Seek 


During the seek, a fault error 
occurred within the drive, as 
reported by the drive. This 
may be any of several errors. 
See the Cromemco Hard Disk 
Specification manual, part 
number 023-6002, for more 
information. 


03 Failed to Seek to Correct Track 


The sector header as read off 
the disk is not what the 
drivers expected, thus the 
current disk location is 
incorrect. 


04 Failed to Read CRC of Header 


The CRC for the header as read 
from the disk is incorrect; it 
is different than what was 
expected. Most likely the 
current disk location is 
incorrect or the media surface 
is damaged. 


Paiaet 


05 Failed to Rezero - Timeout 


A rezero command did not 
complete within a specified 
time. Check the drive 
electronics. 


06 Fault Occurred after Rezeroing 


07 Drive not Ready 


08 Failed to Write 


A fault error occurred within 
the drive after a rezero 
command was executed. This may 
be any of several errors. See 
the Cromemco Hard Disk 
Specification manual, part 
number 023-6002, for more 
information. 


The ready signal from the drive 
is not active. Make sure the 
drive is connected properly. 


- Fault Error 


During the write, a fault error 
occurred within the drive, as 
reported by the drive. This 
may be any of several errors. 
See the’ Cromemco Hard Disk 
Specification manual, part 
number 023-6002, for more 
information. 


09 Failed to Verify after Write 


After data is written to the 
disk, it is read back and 
verified. This error occurs if 
the data cannot be properly 
verified. 


OA Failed to Read - Fault Error 


During the read, a fault error 
occurred within the drive, as 
reported by the drive. This 
may be any of several errors. 
See the Cromemco Hard Disk 
Specification manual, part 
number 023-6002, for more 
information. 


OB Failed to Read - CRC Error 


The CRC just read from the disk 
is incorrect; it is different 
from the expected CRC. This 
error usually means that the 
data just read is incorrect. 


OC Failed to Read - Cannot Locate Sector 


The sector being looked for 
cannot be found on the current 
track. This error can occur if 
the media surface is damaged or 
if the controller electronics 
are not functioning properly. 


OD Surface is Write Protected 


The surface selected for the 
current write command is write 
protected and can not be 
written to. 
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SYSTEM ERRORS 


The following error codes are displayed when a 
system disk error occurs. 


00 No Acknowledge Received from Drive 


The drive did not acknowledge a 
command sent to it. Make sure 
the drive is connected 
properly. : 


01 Drive Remains BUSY - Acknowledge Stuck Low 


The acknowledge signal from the 
drive did not go high again 
after the command strobe went 
inactive. 


02 Timeout Occurred during Rezeroing 


A rezero command did not 
complete within a specified 
time. Check the drive 
electronics. 


03 Fault Condition Reported by Drive 


A fault condition occurred 
within the drive, as reported 
by the drive. This may be any 
of several errors. See the 
Cromemco Hard Disk Drive 
Specification manual, part 
number 023-6002, for more 
information. 


04 Failed to Read - CRC Error 


The CRC just read from the disk 
is incorrect; it is different 
from the expected CRC. This 
error usually means that the 
data just read is incorrect. 


05 Header Off the Disk Does Not Compare with 
Expected Header 


The sector header as read off 
the disk is not what the 


ll 


drivers expected, thus the 
current disk location is 
incorrect. 


06 Failed to Verify after Write Operation 


After data is written to the 
disk, it is read back and 
verified. This error occurs if 
the data cannot be properly 
verified. 
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